home *** CD-ROM | disk | FTP | other *** search
/ Mac Magazin/MacEasy 19 / Mac Magazin and MacEasy Magazine CD - Issue 19.iso / Utilities / Yooz 1.55 US / Yooz User's Manual < prev   
Text File  |  1996-01-22  |  19KB  |  513 lines

  1. YOOZ v1.55US 
  2.                                                                                                                 User's MANUAL
  3.  
  4.                                  
  5.  
  6.  
  7.                       Introduction
  8. What can you use YOOZ for?
  9. + YOOZ keeps track of all applications launched on your Macintosh, providing the date and duration of each session.
  10. + YOOZ helps you assess what your Macintosh is being used for.
  11. + YOOZ helps you evaluate shareware by indicating how much time you spend on each shareware application.
  12. + YOOZ helps you organize your network by distributing right sized Macintosh according to each user's principal needs.
  13. + YOOZ will reveal whether you spend more time on your favorite games than on your word processor.
  14. + System 7.0 or later is required.
  15.  
  16. Yooz is written using CodeWarrior 7 C Language
  17.                                 
  18.                                                      SHAREWARE
  19.  
  20. + You may distribute YOOZ as long as:
  21.    + All files, including the shareware notice, are included.
  22.    + No charge is made without my WRITTEN consent.
  23. + Distribution is also allowed on servers (AOL, Compuserve, eworld ...), CD ROMs (BBS in the box, Quintescence ...) and computer magazines in the respect of the same above conditions …
  24.  
  25. What will you get if you register?
  26. The shareware version of YOOZ has a few limitations that are removed when you enter a personal registration code.
  27.    + You will be able to copy various data, including graphs.
  28.    + You will be able to print from YOOZ.
  29.    + The Export/Merge/Sort/Clean function will be enabled.
  30.    + You will be able to alter the time period information.
  31.  
  32. To receive your registration code, please send 20$US (two 10$US bills, enclosed in a sheet of plain paper, or 100FF) to:
  33.  
  34.    M. Pascal CARDON
  35.    17 cours du Buisson
  36.    77186 NOISIEL
  37.    - FRANCE -
  38.  
  39.    email: pcardon@club-internet.fr
  40.  
  41. Please include:
  42. + Your registered name and the serial number that appears under the "About" menu or
  43. + The file created by the "Request private code" button in the "about" window
  44. + Your money :-)
  45. + Your e-mail address.
  46.  
  47. In return, you'll receive:
  48. + My thanks.
  49. + Your personal code to unlock your copy of YOOZ.
  50. + The latest version of YOOZ.
  51.  
  52. English is not my native language. Please help me to make it better by sending me your comments to :          
  53.                                                                                 pcardon@club-internet.fr
  54.                                 
  55.  
  56.  
  57.  
  58.                                          INSTALLING YOOZ
  59.  
  60. 1/    Minimum requirements
  61. - You will need at least System 7.0 to use this program.
  62. - Succesfully tested with these Mac :
  63.     Mac SE/30, PowerBook 140, PowerBook 145, PowerBook Duo 210, 270c, PowerBook 540c,  Mac IISi, Mac IIci, Mac IIvi with or without 50 Mhz PowerCache card , Quadra 610, Quadra 650, Quadra 800, Power Macintosh 6100/66 (and Macintosh 6100/80 :-)  …), Power Macintosh 8100/80, Performa 6200
  64. - Succesfully tested with these printers :
  65.     StyleWriter, StyleWriter II, Color StyleWriter Pro, Color Stylewriter 2400, Laser Pro 600, HP DeskWriter 560c, Epson Stylus Pro, 
  66. - Succesfully tested with these softwares :
  67. 7.0 system, 7.01, 7.1, 7.5 beta, 7.5 with or without virtual memory, with or without 'New Memory Manager', with or without RamDoubler, with or without SpeedDoubler,  16 or 32 bits, with or without QuickDraw GX.
  68. - A color monitor is recommended.
  69. - A printer is recommended
  70.  
  71. 2/    Yooz files
  72. + YooZ : This is the main part of the package. You can put this program where you want on your disk.
  73. + Yooz Prefs is the preference file of the YooZ program. This file is used to remember the user setup. This file is in the 'Preferences' folder.
  74. + SPYßg : This system extension will record the names of the programs launched on your machine. It will also record the date, the time and the duration of each session. If it's icon doesn't appear as here you may rebuild your desktop, with all extensions disabled.
  75. + SPYßg Prefs is the preference file of the Spyßg extension. This file is in the 'Preferences' folder.
  76. + JobLog : This is the history file created by SPYßg extension. This is the main file used by Yooz. This file may be present in the 'Preferences' folder.
  77.  
  78. 3/    Installing YooZ
  79. - To start using YOOZ, first copy "SPYßg" to your extensions folder
  80. - Restart your Macintosh.
  81.  
  82. 4/    Running YooZ
  83. - You can now run Yooz.
  84. - Enter your name for future registration (the name will be used when computing your registration code).
  85. - On the first start of Yooz, the program may ask you for the Joblog file. It may be present in the "preferences" folder. If no Joblog file can be found, the Spyßg extension is probably not installed.
  86. - When launching Yooz, you may choose another Joblog file by depressing the shift  key.
  87. - If you were using an older version of Yooz, you may discard "Yooz Data" file which is in the "preferences" folder, as it is no longer needed.
  88.                                 
  89.                                                         Yooz menus
  90.  
  91. 1/    The  menu - About
  92. - The About … menu, gives you some informations about the author, and on the Shareware status of your version of YooZ.
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119. - The registration of your SHAREWARE is the best way to expect new releases of this program.
  120.  
  121. 2/    The File menu
  122.     a)    Open
  123. - You may choose this item to read another Joblog file, for example the one of a networked Macintosh.
  124. - Usualy Joblog files may be in the "Preferences" folder.
  125. - A progress window will be displayed to show you that YooZ is 'compiling' the Joblog file.
  126.  
  127.     b)    Close
  128. - This item closes the frontmost window.
  129.  
  130.     c)    Page Setup
  131. - You may use this item to setup the printing options.
  132.  
  133.     d)    Print
  134. - This function only works with a registered version of Yooz.
  135. - This item prints the frontmost window.
  136. - This item works only with the following windows : History, Programs list, Infos, Stats or  Graph.
  137.  
  138.     e)    Quit
  139. - Use this item to quit YooZ. When quitting Yooz, the windows position are saved if so configured in the Setup menu.
  140.  
  141. 3/    The Edit menu
  142.     a)    Copy
  143. - This function only works with a registered version of Yooz.
  144. - This option is available with the graph window if graph is selected, and also with History and Program List windows if a line is selected in the list.
  145.  
  146.     b)    Show Clipboard
  147. - Use this item to see the Clipboard content.
  148.  
  149. 4/    The Windows menu
  150.     a)    Get Infos
  151. - Get Infos shows you informations about the machine from which you are reading the history file.
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.     b)    History
  175. - The History shows you detailed usage of the machine.
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201. - For each session you will see the launch date and time, the program name and the session duration.
  202. - At the bottom of the list is displayed the total time for the selected period.
  203. - The 'Period' button lets you change the period for the history.
  204. - You may display the previous period by clicking on the left arrow button or by typing the '-' key.
  205. - You may display the next period by clicking on the right arrow button or by typing the '+' key.
  206. - If there is a selected line in the list, you may copy it in the Clipboard by using "Copy" in the Edit menu.
  207. - If you double click on a program name, you'll get the records for this program, for the selected period, like shown below :
  208. - At the bottom of the list is displayed the total time of the period for the selected program.
  209. - The "All the programs" button will show the complete history for the selected period.
  210. - The 'Period' button lets you change the period for the history.
  211. - You may display the previous period by clicking on the left arrow button or by typing the '-' key.
  212. - You may display the next period by clicking on the right arrow button or by typing the '+' key.
  213. - If there is a selected line in the list, you may copy it in the Clipboard by using "Copy" in the Edit menu.
  214. - When you click the small "graph icon", you get a graph for the selected program, witin the present period.
  215.  
  216.     c)    Program List
  217. - This item shows you the total used time by program for the selected period.
  218.  
  219.  
  220.  
  221.  
  222.  
  223.  
  224.  
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243. - The 'Period' button lets you change the period for the history.
  244. - You may display the previous period by clicking on the left arrow button or by typing the '-' key.
  245. - You may display the next period by clicking on the right arrow button or by typing the '+' key.
  246. - To sort the list by name, click on the 'list by name' button.
  247. - To sort the list by duration, click on the 'list by duration' button.
  248. - It's possible to select a program (ie to get a copy ot the corresponding line in clipboard), by typing the first letter of its name.
  249. - You may move the selection upward or downward by typing the 'Up Arrow' or 'Down arrow' keys.
  250. - If there is a selected line in the list, you may copy it in the Clipboard by using "Copy" in the Edit menu.
  251. - Double clicking on a program name, or typing "enter" on a selected one will display the detailed history for this program during the selected period.
  252. - When you click the small "graph icon", you get a graph for the selected program, witin the present period.
  253.  
  254.     d)    Stats
  255. - This item gives you some summarized data for the selected period.
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.  
  269.  
  270. - A session is defined as a start of a program, a period of use, followed by a stop of this program.
  271. - The 'Period' button lets you change the period for the history.
  272. - You may display the previous period by clicking on the left arrow button or by typing the '-' key.
  273. - You may display the next period by clicking on the right arrow button or by typing the '+' key.
  274.  
  275.     e)    Graph
  276. - With this item you will get a graph for the whole file, a year, a mont or a day period.
  277.  
  278.  
  279.  
  280.  
  281.  
  282.  
  283.  
  284.  
  285.  
  286.  
  287.  
  288.  
  289.  
  290.  
  291.  
  292.  
  293.  
  294.  
  295.  
  296.  
  297.  
  298. - The horizontal line at top right is followed by the average time for the selected period.
  299. - To Select/De-select the graphic, just click on it. When selected, a dotted line appears, and you may copy it in the clipboard (Copy option of Edit menu).
  300. - The 'Period' button lets you change the period for the history.
  301. - You may display the previous period by clicking on the left arrow button or by typing the '-' key.
  302. - You may display the next period by clicking on the right arrow button or by typing the '+' key.
  303. - You may change the size of the window by dragging the grow box in the bottom right corner.
  304. The position and size will be remembered by YooZ if you have selected this option in the Setup menu.
  305.  
  306.     f)    Choosing a new period
  307. - This function only works in a registered version of Yooz.
  308. - The following window is displayed when clicking on the "Period" button.
  309. - You can choose between the whole file, a year, a month or a day period.
  310. - According to the chosen period some days or months will not be selectable if there are no corresponding data in the "Joblog" file. 
  311. - To cancel your choice click the "Cancel" button.
  312. - To get the chosen period clic "OK", or depress "Enter" key.
  313.  
  314. 5/    The Utilities menu
  315.     a)    Export
  316. - This function only works with a registered version of Yooz.
  317. - This menu is available when the History or the Program List windows are frontmost.
  318. - This gives you the possibility to work with the YooZ data in another program like a Word Processor or a spreedsheet. The file format is "Tab Tab Return". You may choose the document type with the Setup menu.
  319.  
  320.     b)     Merge 2 files
  321. - This function only works with a registered version of Yooz.
  322. -This menu will merge two "Joblog" files in a third file (the originals files are not affected).
  323. - A sort will occur to get the entries in order before saving. 
  324. - This sort could need a lot of time on small machines, with big files and depending on the initial order in the file.
  325. - A progress window shows you the percentage of the operation.
  326.  
  327.     c)    Sort a file
  328. - This function only works with a registered version of Yooz.
  329. - A sort will occur to get the entries in order before saving.
  330. - This sort could need a lot of time on small machines, with big files and depending on the initial order in the file.
  331. - A progress window shows you the percentage of the operation.
  332.  
  333.     d)    Cleanup a file
  334. - This function only works with a registered version of Yooz.
  335. - This item allows you to clean selected entries in the "Joblog" file. You may give a program name and/or a session duration.
  336. - A new file is created, and the master file is not affected.
  337.  
  338.     e)    Setup
  339. - There are two setup windows
  340. - The first window is used to personalize the preference file of YooZ and has two parts:
  341.  
  342.  
  343.  
  344.  
  345.  
  346.  
  347.  
  348.  
  349.  
  350.  
  351.  
  352.  
  353.  
  354.  
  355.  
  356.  
  357.  
  358.  
  359.  
  360.  
  361.  
  362.  
  363.  
  364.  
  365. - In the 1st part you will choose the windows which are displayed when you launch YooZ.
  366.  
  367. - In the 2nd part are buttons to allow or not color printing, allow or not YooZ to save the position of the windows, or hide Yooz's windows when Yooz is in background.
  368. - The "Export to" button will choose the file format used by the "Export" menu.
  369. - The "Colors" button will display the following window to preset various interface colours.
  370. - To cancel clic on "Cancel" or depress "Escape" key.
  371. - To confirm your choices click "OK" or depress "Escape" key.
  372.  
  373. - The second window is used to personalize the preference file of Spyßg.
  374.  
  375.  
  376.  
  377.  
  378.  
  379.  
  380.  
  381.  
  382.  
  383.  
  384.  
  385.  
  386.  
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393.  
  394.  
  395.  
  396.  
  397.  
  398.                                 
  399.                                                   Release Notes
  400. 1.55 Version (01/21/96)
  401. Improvements:
  402. + 2 separates versions : English and French. This results in a smaler and quicker program.
  403. + It's possible to get a graphic for single program, by clicking the 'Graph' icon in either Histo window or program list window.
  404. + Best title display for the graph Window
  405. + New Setup window for Spyßg extension.
  406. + Balloon help with menus, About window and Setup windows.
  407. + New Spybg (2.55) with new recording method. PLEASE have a look to it's readme file.
  408. + Full English error messages
  409. Bugs corrections:
  410. + Bad keyboard shortcuts with windows menu.
  411. + A bug was freezing the mac when printing on SW 2400 printer and others.
  412. + Many memory handling bugs.
  413.  
  414. 1.54 Version (11/07/95)
  415. Improvements:
  416. + New Spybg (2.53) with a new recording method. PLEASE have a look to it's readme file (you may leave 2 different Spybg extensions on your Mac, allowing you to work with the 2 methods).
  417. + Great performance improvement when changing period, mainly with big Joblog files.
  418. + Better performance when processing a Joblog file alternatively by a 68k Mac and a PPC Mac : no more coversion needed.
  419. + Great performance improvement with the sort by name option in the list by program.
  420. + Joblog full Pathname is displayed in the 'Infos window'
  421. + Windows are shown with data during Yooz startup, instead of empty windows.
  422. + More undestandable message when memory gets too low.
  423. + Open menu now works even if Shareware is not registred.
  424. + Miscellaneous code optimisations.
  425. Bugs corrections:
  426. + Windows refresh is now correct when changing colors in the setup menu.
  427. + Correct Period menus when processing many Joblog files.
  428. + Suppress flickering list when using sort options in the list by program.
  429. + Possible program crash when double clicking in the program list.
  430. + Program list no longer display 'SPY' and 'Spybg' if not needed or not used.
  431.  
  432. 1.53 Version (10/25/95)
  433. This is a major version for which the main purpose is to fix bugs.
  434. Improvements:
  435. + Supported again on 68000 Macintosh
  436. + New format to display total times.
  437. + New 2.52 version for Spybg, which is able to fix corrupted resource fork in Joblog file.
  438. Bugs corrections :
  439. + Many bugs were removed (Bus errors, Mac Freeze, corrupted Joblog files, infinite loop at startup ...). Thank's a lot to Diane Kimble, Kirsten Schelper, Robert J. Giusti, Glen Toney for their help in the long debugging process !
  440. + Many fixes in the English user's manual (thanks to Jean-Louis Pastol).
  441. + Comestic bug in Stats window when Joblog is empty (bad program name)
  442. + Comestic bug in About window (troncated messages)
  443. + The 'Ok' button in the machine Info window now works with the mouse.
  444.  
  445. 1.521 Version (10/20/95)
  446. - debugging version
  447.  
  448. 1.52 Version (09/30/95)
  449. Improvements :
  450.     - It's now possible to copy an history line in the Clipboard.
  451.     - It's now possible to copy a line from the list of programs in the Clipboard.
  452.     - New FAT Version for Spy ßg 2.50. This version is needeed to access a new information window below.
  453.     - New 'Machine Information' window, which shows some informations from the machine about which you are reading the history : Mac model, system version, user name ...
  454.  This is very useful when you read Joblog files from networked Macintoshes. To access such
  455.     information you must install SPY ßg V 2.50 and upper.
  456.     - Performance enhancement when reading Joblog files. The "Yooz Datas" file is no longer
  457.     needed, because its data is included in each Joblog file. The speed is greatly improved, and
  458.     will be a very appreciated advantage when reading Joblog files from networked Macintoshes.
  459.     - Automatic column width adjustment, for the displayed date and time in history list.
  460.     - More accurate error messages.
  461.     - English dialog window displayed when launched from a non french system.
  462.     - In case of corrupted data in Joblog file, you may try again, with Shift and Option keys pressed
  463.     when launching Yooz. This may solve some problems.
  464.  Note :  You may give more memory to Yooz than in the previous version. Up to now the memory used by Yooz was mainly taken in system heap. This was useful, but really slowed the process, mainly on PowerMacs with virtual memory. This problem was solved by using Yooz memory instead of system memory, but the total ammount of memory is the same than with older versions.
  465. The drawback of this solution is the need to give more memory to Yooz when the Joblog is
  466. greater, the great benefit is execution speed.
  467.     - English User's Manual available for registered users. For those regisetred users who don't
  468.     have it, email me : pcardon@planete.net
  469.     - New "Read Me" : Thank's to Michel POLLET and Lew IRWIN (AOL)  for the translation.
  470. Bugs corrections:
  471.     - Bug correction with the 'Sort a file' menu
  472.     - Double clicking on a Joblog file works again
  473.     - The "Please Wait" dialog is no longer hidden by the other windows during launch process.
  474.     - The rotating cursor no longer appears in the other programs when Yooz is in the background.
  475.     - Yooz now accept to run on Macintoshes which are running system 7.0, 7.1 as indicated
  476.      in the User's Manual.
  477.     - Depressing Shift key during launch process allows you to change of Joblog file, as indicated 
  478.      in the User's Manual.
  479.     - Cosmetic bugs
  480.     - Translation errors (I need your suggestions on this subject !)
  481.     - Better text in "About Yooz" window.
  482.     - Translation of the "Cancel" button in alert dialogs.
  483.  
  484. 1.51 Version (09/15/95)
  485. • Not distributed
  486.  
  487. 1.50 Version (18/08/95)
  488. Improvements:
  489. • first version available on Internet
  490. • FAT version
  491. • WYSIWYG printing for all windows.
  492. • New preference for "Color printing."
  493. • Some options don't function until you are registered, and the "About" dialog will be displayed systematically:
  494.         - No options available in the "Utilities" menu, except "Preferences."
  495.         - No "Open" option in "File" menu.
  496.         - No "Copy" option in "Edition" menu.
  497.         -"Period" button disabled in the different dialogs.
  498.         - Condensed User's Manual.
  499. Bug corrections:
  500.         - Some problems in the "YOOZ Data" file may make the program fail to start.
  501.         - Does not work at all on some PowerMacintosh
  502.         - Program failure when total time is null
  503.         - Bus Error when changing "Display colors" option.
  504.         - Bus Error when changing graphic colors, if no graph window is displayed
  505.  
  506. 0.5 Version (01/06/92)
  507. • first usable version
  508.  
  509. 0.05 Version (05/03/91)    
  510. • first beta version
  511.  
  512. Kown problems
  513. • Double bytes fonts are not supported.